/*
 * IMBlockStorage.nc -- block storage interface
 *
 * Copyright (C) Andrey Vihrov <andrey.vihrov@gmail.com>, 2010
 * Copyright (C) Askar Salimbaev <ghostinshell@gmail.com>, 2010
 *
 * This file is part of Intermote.
 *
 * Intermote is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * Intermote is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with Intermote.  If not, see <http://www.gnu.org/licenses/>.
 */

#include <TinyError.h>

#include <Intermote.h>

interface IMBlockStorage {

	/**
	 * Allocate a block
	 */
	command	error_t allocate (void);

	/**
	 * Erase a block
	 */
	command error_t erase (im_block_id_t block);

	/**
	 * Read a chunk of data
	 */
	command error_t read (im_block_id_t block, im_off_t offset, struct im_chunk *buf);

	/**
	 * Write a chunk of data
	 */
	command error_t write (im_block_id_t block, im_off_t offset, const struct im_chunk *buf);

	/**
	 * Reserve @count replication blocks per data block
	 */
	command error_t reserve (uint8_t count);


	/* Completion events */

	event void allocateDone (error_t err, im_block_id_t block);

	event void readDone (error_t err);

	event void writeDone (error_t err);

	event void eraseDone (error_t err);

}
